R Portfolio

Visual Documentation

A complete walkthrough of the R Portfolio interface.

API Reference and docs:

View API Docs | GitHub Repository

R Portfolio README.md


Flutter Dart

Platform Platform Platform Platform Platform Platform

License Status

Download v0.1.0 Last Release

Current Version: v0.1.0 View API Docs and Visual Docs

A personal, open-source Flutter application developed to manage and document medical residency portfolio activities, with specific reference to Italian Residency Schools and their normative and training requirements.

This project is developed and maintained by medlav and will be available in a public GitHub repository. It was created primarily for personal organizational use and is shared openly in case it may be useful to others or serve as a basis for further development.

This is not production-grade software and should not be used as an official reporting system without independent verification.


Context and Scope

Italian medical residency programs require structured documentation of:

This application aims to provide a simple, structured, and locally stored system for recording such activities.

It is not affiliated with any university, residency school, or governmental institution.


Normative Context (Italy)

This application is designed to align with Italian postgraduate medical training frameworks (e.g., D.M. 68/2015 and specialty-specific regulations). It facilitates the organization of required competencies, including:

Important Disclaimers


Project Status

Expect:

This is a hobby project developed in spare time.


Portfolio Entry Management

Temporal Tracking

Local-First Design

All data remains stored locally on the user’s device.


Architecture Overview

The application uses:

SQLite

SharedPreferences

There is currently no synchronization, encryption layer beyond platform defaults, or institutional integration.


Installation

You can also download the apk binary for easy installation Here

Clone the public repository:

git clone https://github.com/medlav/residency_portfolio.git
cd residency_portfolio

Install dependencies:

flutter pub get

Run the application:

flutter run

Build release APK:

flutter build apk --split-per-abi

Testing

Example test execution:

flutter test test/database_security_test.dart

Test coverage is currently limited and may evolve over time.


Limitations

Users remain responsible for ensuring compliance with their specific institutional or national requirements.


Contributing

Contributions are welcome, including:

To contribute:

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request

As this is a personal project, response times may vary. (Also my first FOSS project)


License

This project is licensed under the BSD 3-Clause License.

You are free to use, modify, and redistribute the software under the terms of that license.


Author

Developed and maintained by medlav.

This project was created as a personal tool to better structure and document residency activities in accordance with Italian training requirements. It is shared publicly in the spirit of openness and collaboration.

If it proves useful to others, that is a welcome outcome.